<html>
<head>
	<title>JP2MrSID --- JPEG2000 via MrSID SDK</title>
</head>

<body bgcolor="#ffffff">

<h1>JP2MrSID --- JPEG2000 via MrSID SDK</h1>

JPEG2000 file format is supported for reading with the MrSID DSDK.  It
is also supported for writing with the MrSID ESDK.<p>

JPEG2000 MrSID support is only available with the version 5.x or newer
DSDK and ESDK.<p>

<h2><a name="georeferencing">Georeferencing</a></h2>

<p>
Georeferencing information can come from different sources : internal (GeoJP2
or GMLJP2 boxes), worldfile .j2w/.wld sidecar files, or PAM (Persitant Auxiliary metadata)
.aux.xml sidecar files.
By default, information is fetched in following order (first listed is the most
prioritary): PAM, GeoJP2, GMLJP2, WORLDFILE.
</p>
<p>Starting with GDAL 2.2, the allowed sources
and their priority order can be changed with the GDAL_GEOREF_SOURCES
configuration option (or GEOREF_SOURCES open option) whose value is a
comma-separated list of the following keywords :
PAM, GEOJP2, GMLJP2, INTERNAL (shortcut for GEOJP2,GMLJP2), WORLDFILE, NONE.
First mentioned sources are the most prioritary over the next ones. A non mentioned
source will be ignored.
</p>
<p>
For example setting it to "WORLDFILE,PAM,INTERNAL" will make a geotransformation
matrix from a potential worldfile prioritary over PAM or internal JP2 boxes.
Setting it to "PAM,WORLDFILE,GEOJP2" will use the mentioned sources and
ignore GMLJP2 boxes.
</p>

<h2>Creation Options</h2>

If you have the MrSID ESDK (5.x or newer), it can be used to write JPEG2000
files.  The following creation options are supported.

<ul>
<li> <strong>WORLDFILE=YES</strong>: to write an ESRI world file (with the extension
  .j2w).
  <p>
<li> <b>COMPRESSION=n</b>: Indicates the desired compression ratio.  Zero indicates
lossless compression.  Twenty would indicate a 20:1 compression ratio (the
image would be compressed to 1/20 its original size).
  <p>

<li> <strong>XMLPROFILE=[path to file]</strong>: Indicates a path to a LizardTech-specific
  XML profile that can be used to set JPEG2000 encoding parameters. They can
  be created
  using
the MrSID ESDK, or with GeoExpress, or by hand using the following example as
a template:
  <p>
<pre>
&lt;?xml version="1.0"?&gt;
&lt;Jp2Profile version="1.0"&gt;
  &lt;Header&gt;
    &lt;name&gt;Default&lt;/name&gt;
    &lt;description&gt;LizardTech preferred settings (20051216)&lt;/description&gt;
  &lt;/Header&gt;
  &lt;Codestream&gt;
    &lt;layers&gt;
      8
    &lt;/layers&gt;
    &lt;levels&gt;
      99
    &lt;/levels&gt;
    &lt;tileSize&gt;
      0 0
    &lt;/tileSize&gt;
    &lt;progressionOrder&gt;
      RPCL
    &lt;/progressionOrder&gt;
    &lt;codeblockSize&gt;
      64 64
    &lt;/codeblockSize&gt;
    &lt;pltMarkers&gt;
      true
    &lt;/pltMarkers&gt;
    &lt;wavelet97&gt;
      false
    &lt;/wavelet97&gt;
    &lt;precinctSize&gt;
      256 256
    &lt;/precinctSize&gt;
  &lt;/Codestream&gt;
&lt;/Jp2Profile&gt;

</pre>
</ul>

<h2>See Also:</h2>

<ul>
<li> Implemented as <tt>gdal/frmts/mrsid/mrsiddataset.cpp</tt>.<p>

<li> <a href="http://www.lizardtech.com">LizardTech's Web site</a><p>

</ul>

</body>
</html>

